home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / english / mffm107d / mfsfm.doc < prev    next >
Text File  |  1995-11-25  |  9KB  |  224 lines
  1. MfsfM (Marcus' file selector for MiNT) Copyright 1993 by Marcus Haebler
  2.  
  3. DISCLAIMER:
  4. -----------
  5.  
  6.   I ACCEPT NO RESPONSIBILITY FOR ANY DAMAGE CAUSED BY THE USE OF THIS
  7. PROGRAM, WHETHER IT IS USED CORRECTLY OR NOT. I GIVE ABSOLUTELY NO WARRANTY
  8. FOR THIS PROGRAM, NOT EVEN AN IMPLIED WARRANTY OF FITNESS FOR A PARTICULAR
  9. PURPOSE. IF YOU DECIDE TO USE THIS PROGRAM, YOU'RE COMPLETELY ON YOUR OWN!
  10.  
  11.  
  12. SHAREWARE
  13. ---------
  14.  
  15. This program is shareware. That means that you have to PAY the shareware fee
  16. if you use it regulary. The fee is 10 DM.  This should not be too much.
  17. Send it to the address below and INCLUDE AN ADRESSED AND STAMPED ENVELOPE
  18. AND A FORMATED DISK. You can also send the money to my bank account but
  19. then you have to pay 13 DM. Sorry for this but I think that it is still
  20. cheaper than sending me 10 DM with an envelope.
  21. (If you are able to receive uuencoded emails from the Internet then you
  22. can send me 10 DM (envelope or bank account). You won't get a disk then.
  23. All new version will reach you automatically.)
  24. What will you get for this? You will get an full version of MfsfM. Is this
  25. all? No. You will also get all updates automatically if you have an email
  26. address. DON'T FORGET TO INFORM ME WHAT'S YOUR EMAIL ADDRESS.
  27.  
  28.  
  29. INTRODUCTION
  30. ------------
  31.  
  32. Today I decided to write this short documentation for my file selector
  33. because it became a little bit complex. I hope that you read this file.
  34. I know reading docs is boring. Please make shure to have MiNT running!!!
  35.  
  36.  
  37. ABOUT MfsfM
  38. -----------
  39.  
  40. MfsfM was and is a file selector for PRAX (something like MultiTOS). _uk_
  41. asked me if I could write the file selector for it. First of all I hasitated
  42. a little bit because I had no experience with something like this but in
  43. the end I said yes.
  44. It is quite difficult for me to write something like this because I am
  45. studying chemistry. The study takes a lot of time.
  46. Now why is MfsfM different from all other file selectors (all file selectors
  47. I know)? MfsfM uses only U:. This means that you get a structure like Un*x
  48. uses it. U: is the root directory. In root you will find all your normal
  49. TOS drives mounted. This is done by MiNT. MfsfM supports long file names
  50. and case sensitiv file systems like the Minix file system or Ydisk.
  51. MfsfM follows the "TOS goes Un*x" trend. I hope that Atari will follow this
  52. trend, too.
  53.  
  54.  
  55. INSTALLATION
  56. ------------
  57.  
  58. There are four ways to install MfsfM:
  59.  
  60. 1) For this you have to be owner of MultiTOS. Just insert a line
  61.     "run <full path and and file name>" in GEM.CNF.
  62.     Example: run d:\gnu\source\mfsfm\mfsfm.prg
  63.     NOTE: If you are running MultiTOS you _MUST_ use GEM.CNF!
  64.  
  65. 2) Install MFSFM.PRG as auto boot in your DESKTOP.INF (or NEWDESK.INF).
  66.     This might be not the best choice if you are using GEMINI or something
  67.     like this.
  68.  
  69. 3) Insert a line with "exec <full path and file name>" in MINT.CNF. You
  70.     have to add a number of seconds to this line. This is necessary
  71.     to give GEM time to launch accessories. Five seconds work quite well
  72.     on my system with two accessories.
  73.     Example: exec d:\gnu\source\mfsfm\mfsfm.prg 5
  74.     NOTE: Install it here _ONLY_ if you are running the old singletask AES!
  75.  
  76. 4) Start MFSFM.PRG from the desktop. It will install itself in trap #2.
  77.  
  78.  
  79. PATH AND FILE NAME
  80. ------------------
  81.  
  82. You will find that the path and file name are scrollable. The file name is
  83. not scrollable on a TOS file system because there is no need for this.
  84. If you click on the path or the file name and it was not editable it becomes
  85. editable. If you have clicked on the path and the file name is a valid file
  86. this file will be automatically selected. Play around with it.
  87. There is a function I should mention: If you double click the path the
  88. directory  is read. You can also use this function to reread a directory.
  89.  
  90.  
  91. THE FILE WINDOW
  92. ---------------
  93.  
  94. Everything should be easy to use. Just a few words concerning the bar at the
  95. top. If you double click it you will be able to change the regular
  96. expression.
  97. "?" and "*" are working like in the TOS file selector. "*.*" is equal to "*".
  98. See OPTIONS.
  99. With the double arrows you can get further information about the files.
  100. Since 1.04 there are icons instead of type characters. You have to use
  101. a System font >= 16 * 8 to get them.
  102. Also since 1.04 there is a popup on the "\"-button. If you select a
  103. drive letter in the popup it has the same effect as clicking on a
  104. drive letter in the original file selector.
  105. NOTE: If the caller runs in the TOS domain. You can only see regular
  106. files and directories. If the caller is in the MiNT domain you the
  107. file selector uses Fxattr(). The effect is that you can see links,
  108. processes, character devices and pipes, too.
  109.  
  110.  
  111. OPTIONS
  112. -------
  113.  
  114. Here you can set up the behavior of the file selector:
  115.   o Follow links: Fxattr will follow links if this is turned on.
  116.   o Hide TOS hidden files: TOS file with hidden attribute are not shown.
  117.   o Hide Un*x hidden files: files with a leading "." are not shown.
  118.   o Online slider: the slider becomes an online slider.
  119.   o Save last path: The file selector ignores the path that is passed to it
  120.     it uses the last shown path.
  121.   o "*.*" is equal to "*": What do you exspect?
  122.  
  123. Since version 1.05 you can save the options. The file mfsfm.cnf can be
  124. put in the root dir of every drive. It will be searched automatically
  125. for this. The search is done in the following order: C, D, ..., Z, A, B
  126. This means that the disk drives are the last drives.
  127. If you set the environment variable MFSFMCNF to e.g.
  128. d:\dir\subdir\mfsfm\mfsfm.cnf you can put the config file everywhere.
  129.  
  130.  
  131. THE SORT POPUP
  132. --------------
  133.  
  134. You can choose the method of sorting here. The options "reverse", "numbers",
  135. "dir2top" and the actual method are saved in mfsfm.cnf. There are the
  136. following entries int the popup:
  137. by name: sort by name
  138. by type: sort by file type (directory, regular file, symbolic link etc.)
  139. by ext.: sort by extension. The extension is the string that follows the
  140.          last "." in the file name. "Z" is the extension of "test.tar.Z"
  141. by size: sort by the length of a file.
  142. by date: sort by the time stamp of a file.
  143. no sort: no sorting, options like "reverse", "dir2top" are ignored.
  144. There are also the following options:
  145. reverse: sort in reverse order.
  146. numbers: look at numbers. This means that "test2" stands before "test10".
  147. NOTE: THIS OPTION IS NOT ACTUALLY SUPPORTED IN 1.07.
  148. dir2top: directories are sorted to the top.
  149.  
  150.  
  151. THE "FILE..." POPUP
  152. -------------------
  153.  
  154. This popup supports various file operations. If you want e.g. to move a
  155. file do the following things. Klick file. Klick "mark" in the popup.
  156. Change to the target path. Klick "move" in the popup. If you only want to
  157. rename a file mark it. Type the new name in the selection field and klick
  158. on "move".
  159. It is important to know that the operations in the popup refer to the file
  160. name in the selection field. You can also type a name of a directory in the
  161. and delete it. Moving and copying is impossible with directories.
  162.  
  163.  
  164. SIGNALS
  165. _______
  166.  
  167. You can send signals to MfsfM. It catches the following signals:
  168. Signals to kill MfsfM cleanly: SIGHUP, SIGINT, SIGQUIT, SIGTERM
  169. NOTE: MfsfM is not killed at once. If it recognizes that the file selector
  170.       is not called at the moment, it terminates. If the file selector is
  171.       active, then it waits for the file selector.
  172. There is also the possibility to disable MfsfM for a short time. Send a
  173. SIGTSTP (Nummer 18) to MfsfM. Send a SIGCONT (Nummer 19) to enable it.
  174. NOTE: If MfsfM is disabled this does _not_ mean that it is no longer in
  175.       the xbra chain. There is a flag set after a SIGTSTP. The effect is
  176.       that the caller falls through.
  177.  
  178.  
  179. THE END
  180. -------
  181.  
  182. This was all. I hope that this documentation is short enough to be read by
  183. everyone. If you have further questions drop me a note.
  184.  
  185.  
  186. THANKS GO TO
  187. ------------
  188.  
  189.  - my girl friend Nicole for her patience and comprehension.
  190.  - _uk_ (Uli) for inspiration, ideas, critics and help.
  191.  - Eric for MiNT and answering my questions so quickly.
  192.  - rosebud (Uwe) for trying to answer my stupid questions and testing.
  193.  - Spell for the idea of making PRAX, ideas and bug reports.
  194.  - tfs and _Zork_ for ydisk.
  195.  - Julian for the idea with the small images.
  196.  - the authors of xv3.00 for their nice images.
  197.  - tfs for the symbolic link image.
  198.  - spoil(Laurenz) for ideas and critics.
  199.  - Gryf, Dirch and Chris for ideas, critics and bugreports.
  200.  - and all the others for answering my questions.
  201.  
  202.  
  203. GREETINGS TO
  204. -------------
  205.  
  206. _uk_, Spell, tfs, rosebud, Uzul, cortex, _Zork_, connect, Hackbear,
  207. Wizzcat, Knightman, ki (I am waiting for the new Sysmon), ah, eye, gsch,
  208. daryl_, Marsu, Gard, Gero, spoil, dirch, Gryf ... and all the others
  209. on #Atari.
  210.  
  211.  
  212. --- Marcus
  213.  
  214. Address:            Email:                        Voice:
  215.    Marcus Haebler   haebler@uni-muenster.de
  216.    Althausweg 29               or                 02 51 / 21 33 93
  217.    48159 Muenster   srb114@math.uni-muenster.de
  218.    Germany
  219.  
  220. IRC: D_Gently
  221.  
  222. Bankverbindung:
  223. Stadtsparkasse Muenster, BLZ 400 501 50, Kontonummer: 109 070 946
  224.